package com.weijian.demo1.config;

import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import io.swagger.v3.oas.models.info.License;
import io.swagger.v3.oas.models.servers.Server;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import java.util.List;

/**
 * Knife4j API文档配置类
 * 配置OpenAPI 3.0规范文档信息
 * 访问地址: http://localhost:8080/doc.html
 *
 * @author weijian
 * @version 1.0.0
 */
@Configuration
public class Knife4jConfig {

    @Value("${server.port:8080}")
    private String port;

    /**
     * 配置OpenAPI文档基本信息
     *
     * @return OpenAPI配置对象
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                .info(new Info()
                        .title("🚀 协同文档编辑系统 API文档")
                        .description("基于WebSocket的实时多人协同文档编辑系统，支持用户注册、团队管理、文档协作编辑等核心功能")
                        .version("v1.0.0")
                        .contact(new Contact()
                                .name("技术支持")
                                .email("support@collaborative-docs.com")
                                .url("https://gitee.com/weijian-huang/collaborative-document-editor"))
                        .license(new License()
                                .name("MIT License")
                                .url("https://github.com/weijian-huang/collaborative-document-editor/blob/master/LICENSE")))
                .servers(List.of(
                        new Server().url("http://localhost:" + port).description("本地开发环境"),
                        new Server().url("https://api.collaborative-docs.com").description("生产环境")
                ));
    }
}